home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr24 / dup21.zip / H2F21.DOC < prev   
Text File  |  1993-04-08  |  16KB  |  508 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                       H 2 F
  21.  
  22.  
  23.  
  24.                    Version 2.1
  25.  
  26.  
  27.  
  28.                   Documentation
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.       H2F   Copyright 1992, 1993   Chang Ping Lee   ALL RIGHTS RESERVED
  56.  
  57.  
  58.  
  59.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  1
  60.  
  61.  
  62.  
  63.                   Table Of Contents
  64.  
  65.  
  66.       Disclaimer of warranty. . . . . . . . . . . . . . . . . . . .  2
  67.  
  68.       License . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  69.  
  70.       1.   Introduction . . . . . . . . . . . . . . . . . . . . . .  4
  71.  
  72.       2.   How to install and run H2F . . . . . . . . . . . . . . .  5
  73.  
  74.       3.   Configuration file and command line arguments. . . . . .  6
  75.  
  76.       4.   Inside CONFIG.DCF. . . . . . . . . . . . . . . . . . . .  7
  77.  
  78.       5.   Command line arguments and examples. . . . . . . . . . .  8
  79.  
  80.       6.   What will be copied, what will not . . . . . . . . . . . 10
  81.  
  82.       7.   Benchmark. . . . . . . . . . . . . . . . . . . . . . . . 11
  83.  
  84.  
  85.  
  86.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  2
  87.  
  88.  
  89.  
  90.             DISCLAIMER  OF WARRANTY
  91.  
  92.  
  93.     THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS." THE AUTHOR HEREBY
  94.     DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  95.     DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  96.     TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  97.     PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
  98.     TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
  99.     SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
  100.     OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  101.  
  102.  
  103.     DUE TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS
  104.     HARDWARE AND SOFTWARE ENVIRONMENTS IN WHICH THIS SOFTWARE MAY
  105.     BE USED, IT IS UNDERSTOOD THAT OCCASIONAL "BUGS" OR UNFITNESS
  106.     MAY ARISE. THE USER SHOULD ALWAYS TEST THIS SOFTWARE THOROUGHLY
  107.     WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  108.  
  109.  
  110.  
  111.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  3
  112.  
  113.  
  114.  
  115.                 LICENSE
  116.  
  117.  
  118.     1. In return for the payment of a one time fee, the customer is
  119.     granted a non-commercial or commercial license.
  120.  
  121.     2. If the registration is for a non-commercial license the customer
  122.     can use the software for personal backup or other usages in which
  123.     the customer make no profit and the duplicated diskettes of any
  124.     particular source diskette (or image file) are not distributed to
  125.     more than ten persons. In addition, the software may not be used in
  126.     any business, organization, institution or government agency.
  127.  
  128.     3. If the registration is for a commercial license the customer can
  129.     use the software in a business, organization, institution or
  130.     government agency, for profit or non-profit purposes. With a
  131.     commercial license the customer can distributed the duplicated
  132.     diskettes to as many persons as he or she likes
  133.  
  134.     4. The customer may use the product just-like-a-book which means
  135.     this software can be used by more than one person and can be moved
  136.     from one computer to another so long as there is NO POSSIBILITY of
  137.     it being used by two different persons on two different computers
  138.     at the same time, just like a book can not be read by two different
  139.     persons in two different places at the same time.
  140.  
  141.     5. This software and its documentation and all supplemental files
  142.     are property of the author and may not be duplicated for sale to
  143.     any third parties without written permission from the author.
  144.  
  145.     6. The customer agrees that this product is protected by United
  146.     States copyright law and international copyright treaty provisions.
  147.     Purchase of this license does not transfer any right, title or
  148.     interest in the product to the customer except as specifically set
  149.     forth in this license agreement.
  150.  
  151.     7. The author of this software product reserves the right to
  152.     terminate this license upon breach.
  153.  
  154.  
  155.  
  156.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  4
  157.  
  158.  
  159.  
  160.     1. INTRODUCTION:
  161.  
  162.  
  163.        H2F (Hard disk to Floppy) is a utility to copy recursively from
  164.        current directory on hard disk or RAM disk to a diskette at very
  165.        high speed. This program combined with H2F is ideal for backing
  166.        up a small directory.
  167.  
  168.  
  169.        For performance information see page 9 of this documentation.
  170.  
  171.  
  172.        WARNING: H2F do not preserve any file on floppy. It creates a
  173.             new diskette no matter the floppy contains any data or
  174.             not. ALL DATA ON TARGET DISKETTE WILL BE OVERWRITTEN.
  175.  
  176.  
  177.  
  178.  
  179.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  5
  180.  
  181.  
  182.  
  183.     2. HOW TO INSTALL AND RUN H2F
  184.  
  185.  
  186.        Copy the EXE and DOC files to a directory created for DCF and
  187.        DUP. Define the PATH in your AUTOEXEC.BAT to include this
  188.        directory or the directory of a one-line batch file which
  189.        contains the path of H2F.EXE.
  190.  
  191.  
  192.        Type "H2F" followed by the "enter" key to execute the program.
  193.        The first time you run the program it will ask for a formatted
  194.        diskette so that it can create a FMT.DAT file.
  195.  
  196.  
  197.        After the FMT.DAT file has been created, you can start copying
  198.        from a hard disk or RAM disk directory to a floppy disk. You
  199.        can specify the source directory and the target floppy drive on
  200.        the command line. If no source directory is specified the
  201.        current directory is assumed.
  202.  
  203.  
  204.        If you only have one or two floppy drives you can skip the rest
  205.        of this section.
  206.  
  207.  
  208.        In systems with four floppy drives, if a device driver which
  209.        came with the controller is installed H2F usually can detect the
  210.        drive letters automatically and the drive letters should be used
  211.        to specify the third and fourth drives. If no device driver
  212.        (TSR) is installed you need to use 3 and 4 as the drive letters
  213.        for the third and fourth drives. In this case you need to edit a
  214.        text file, CONFIG.DCF, that provides the information on floppy
  215.        drive capacity.
  216.  
  217.  
  218.        The following is an example of the text file in which a 1.2MB,
  219.        a 1.44MB and a 360KB drives are specified as the first, the
  220.        second and the third drives with drive letters A: B: and G:,
  221.        respectively. The 0 on the last line indicates that the fourth
  222.        drive is not installed. If all drives are defined, such as in
  223.        the example, H2F will not check with DOS for drive capacity.
  224.        This can speed up the initialization process.
  225.  
  226.        $DRIVE
  227.         1 1200 A:
  228.         2 1440 B:
  229.         3  360 G:
  230.         4    0
  231.  
  232.  
  233.  
  234.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  6
  235.  
  236.  
  237.  
  238.     3. CONFIGURATION FILE AND COMMAND LINE ARGUMENTS
  239.  
  240.  
  241.        If you have read the DOC file of DCF you can skip this section
  242.        and continue at section 5.
  243.  
  244.  
  245.        Basically, configuration file is used to stored information
  246.        which you don't expect to change often while command line
  247.        arguments are used for specifying more dynamic parameters.
  248.  
  249.  
  250.        For example, it's unlikely that you need to change the drive
  251.        capacity often, so these information can only be specified in
  252.        the configuration file, not on the command line.
  253.  
  254.  
  255.        On the other hand, it's unlikely that you use the same source
  256.        and target each time, so these can only be specified on the
  257.        command line, not in the configuration file.
  258.  
  259.  
  260.        The only information you can specified both in the configuration
  261.        file and command line is the default options. You may have your
  262.        own idea how the defaults should be (in configuration file) and
  263.        make a slight adjustment (on command line) when necessary. In
  264.        other words, command line options override the configuration
  265.        file options.
  266.  
  267.  
  268.        The configuration file is a text file. The default file name is
  269.        CONFIG.DCF. If you use the default file name you can simply type
  270.        "H2F" at DOS prompt and the program will retrieve information
  271.        from the file automatically.
  272.  
  273.  
  274.        There are cases that you need to use a different name. For
  275.        example, you may want to keep two configuration files for
  276.        different applications. In this case you need to provide the
  277.        file name on the command line. For example, if file ABC is your
  278.        configuration file you need to type "H2F @ABC" at DOS prompt.
  279.  
  280.  
  281.        The usage of the configuration file is explained in the next
  282.        section. The usage of command line arguments is fully explained
  283.        in section 5.
  284.  
  285.  
  286.  
  287.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  7
  288.  
  289.  
  290.  
  291.     4. INSIDE CONFIG.DCF
  292.  
  293.  
  294.        If you have read the DOC file of DCF you can skip this section
  295.        and continue at section 5.
  296.  
  297.  
  298.        The user can specify up to seven keywords in the configuration
  299.        file. Each keyword specify a specific kind of parameters or
  300.        information.
  301.  
  302.  
  303.        $DRIVE : You don't need to provide this information except for
  304.             the following two cases. If the program fails to get
  305.             the correct drive capacity from your system or if you
  306.             want to access four drives without installing the
  307.             device driver which came with the controller you can
  308.             use this keyword to specify the drive capacity in the
  309.             CONFIG.DCF file.
  310.  
  311.             The next few lines contain parameters about diskette
  312.             drives in your system. On each line, the first number
  313.             specify the drive, 1 for drive A:, 2 for drive B:, 3
  314.             and 4 for third and fourth drives in a four drive
  315.             system. The second number is the drive capacity in KB.
  316.             A drive letter (optional) can be specified at the end.
  317.             See section 4 of DCF40F.DOC for details.
  318.  
  319.  
  320.        $OPTION : The next few lines specify the default options used by
  321.              H2F at start up. The format is the same as those on
  322.              the command line but without the leading /. See
  323.              section 5 for details.
  324.  
  325.  
  326.        $SYSPATH : The next line specifies the path for system file.
  327.               For example, FMT.DAT is considered a system file.
  328.  
  329.  
  330.        $IMGPATH : Not used by H2F.
  331.  
  332.  
  333.        $TMPPATH : The next line specifies the alternative path for the
  334.               program to create temporary files. If you have a RAM
  335.               disk, you can specify the path to be on your RAM
  336.               disk. Not only speed will be faster but also you save
  337.               your hard disk from unnecessary burden.
  338.  
  339.  
  340.        $NOMSG : Not used by H2F.
  341.  
  342.  
  343.  
  344.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  8
  345.  
  346.  
  347.  
  348.     5. COMMAND LINE ARGUMENTS AND EXAMPLES
  349.  
  350.  
  351.        If you have read the DOC file of DCF you only need to learn the
  352.        q and t options.
  353.  
  354.  
  355.        There are fourteen options you can specify using command line
  356.        arguments. You can also specify these options in the CONFIG.DCF
  357.        file. The command line options override the CONFIG.DCF options.
  358.  
  359.  
  360.        In addition, you can also specify an alternative configuration
  361.        file on the command line. See examples at the end of this
  362.        section.
  363.  
  364.  
  365.        Note that the '+' sign after any option can be omitted.
  366.  
  367.  
  368.        /c  followed by +/-. Set Compare ON/OFF. When ON the program
  369.            performs read-back and byte-by-byte comparison for every
  370.            track written to a target diskette.  Default is ON.
  371.  
  372.        /m  followed by +/-. Set Format ON/OFF. When ON the program
  373.            formats before writing to target diskettes. If OFF the
  374.            program will format only when necessary.  Default is OFF.
  375.  
  376.        /f  followed by +/-. Set Fast ON/OFF. When ON the program will
  377.            only write the portion with active data and skip empty
  378.            portion of diskettes.  Default is ON.
  379.  
  380.        /s  followed by +/-. Set Sound ON/OFF. When ON the program will
  381.            give an audio signal after writing a diskette or 20 seconds
  382.            of inactivity. Default is ON.
  383.  
  384.        /q  followed by +/-. Set Query ON/OFF. When ON the program will
  385.            give warning that all files on the target diskette will be
  386.            overwritten. Default is ON.
  387.  
  388.        /k  Not used by H2F.
  389.  
  390.        /n  Not used by H2F.
  391.  
  392.        /d  followed by +/-. Set Delay ON/Off. If your machine is not so
  393.            slow as an 8088/4.77MHz and would like to see whether the
  394.            program can copy at highest speed on your system try /d-.
  395.            Default is ON.
  396.  
  397.  
  398.  
  399.       H2F   Copyright 1992, 1993   Chang Ping Lee                   page  9
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.        /t  followed by +/-. Set target density. In DCF, this option is
  407.            used for source density. In H2f, however, it is used for
  408.            specifying target density. If + the program creates high
  409.            density diskette in a 1.2 or 1.44MB drive. If - it creates
  410.            low density diskette instead. No default is assumed.
  411.  
  412.        /o  followed by +/-. Set "mono in color" mode. In a color
  413.            system, you can use /o+ to force H2F run in black and white.
  414.            Default is -.
  415.  
  416.        /x  Not used by H2F.
  417.  
  418.        /b  Not used by H2F.
  419.  
  420.        /a  followed by +/-. Set analyze ON/OFF. If ON the program will
  421.            check density before copying to a target diskette. If you
  422.            copy a low density to a high density disk (usually a
  423.            mistake) the program will give a warning and you can decide
  424.            to skip, go ahead, or format before writing. Default is ON.
  425.  
  426.        /w  Not used by H2F.
  427.  
  428.        @file_name  specify alternative name for the configuration file.
  429.  
  430.        dir_name  define dir_name as source directory.
  431.  
  432.        drive:  define a floppy drive as target drive.
  433.  
  434.  
  435.        EXAMPLES:
  436.  
  437.  
  438.        H2F /t+q-d-    Set defaults of target Density, Query and Delay
  439.               to HIGH, OFF and OFF.
  440.  
  441.        H2F /tq-d-     Same as the last example. The '+' can be and is
  442.               omitted.
  443.  
  444.        H2F A:         Copy current directory to drive A:.
  445.  
  446.        H2F D1 B:      Copy sub-directory D1 to drive B:.
  447.  
  448.        H2F C:\D1 3:   Copy directory C:\D1 to the third drive, when
  449.               device driver is not installed.
  450.  
  451.        H2F C:\D1 G:   Same as the last example, but in this case the
  452.               driver is installed and the drive letters is G.
  453.  
  454.  
  455.  
  456.       H2F   Copyright 1992, 1993   Chang Ping Lee                  page  10
  457.  
  458.  
  459.  
  460.     6. WHAT WILL BE COPIED, WHAT WILL NOT
  461.  
  462.  
  463.        H2F copies the current directory recursively to a floppy which
  464.        means all the files and sub directories structure in the current
  465.        directory are copied to the target diskette.
  466.  
  467.        IMPORTANT: H2F does NOT preserve any file on the target diskette.
  468.               Make sure the diskette do not contains important data
  469.               before using H2F.
  470.  
  471.        The names, times, dates and attributes of all the files copied to
  472.        the target diskette are preserved.
  473.  
  474.  
  475.  
  476.       H2F   Copyright 1992, 1993   Chang Ping Lee                  page  11
  477.  
  478.  
  479.  
  480.     7. BENCHMARK
  481.  
  482.  
  483.                   H2F vs XCOPY      F2H vs XCOPY
  484.        --------------------------------------------------
  485.         Case 1 (1.2 MB)    8  vs  40         8  vs  17
  486.         Case 1 (1.44MB)    9  vs  50         9  vs  19
  487.         Case 2 (1.2 MB)    9  vs  33         9  vs  18
  488.         Case 2 (1.44MB)    8  vs  40         9  vs  19
  489.         Case 3 (360 KB)   18  vs 135        19  vs  27
  490.         Case 3 (1.2 MB)   11  vs  93        12  vs  19
  491.         Case 3 (1.44MB)   11  vs 106        12  vs  18
  492.  
  493.  
  494.         Note: (1) Case 1 contains 36 files and no sub directory.
  495.               Case 2 contains 13 files in 21 sub directories.
  496.               Case 3 contains 80 files in 28 sub directories.
  497.               Total file size is about 300 KB in all cases.
  498.  
  499.  
  500.           (2) Performance varies on different system. The
  501.               above benchmark result is provided as examples,
  502.               NOT guarantee.
  503.  
  504.  
  505.           (3) The above results were measured with a RAM disk
  506.               on a 33 MHz 386 compatible system.
  507.  
  508.